Netplan Migration in Logpoint¶

Netplan is a network configuration utility for Linux operating systems that uses YAML files to define configuration. Using YAML files makes it simple to manage network interfaces, IP addresses, and other network settings.

Logpoint uses it from v7.2.0 onwards. Logpoint will stop supporting network configurations not based on Netplan in an upcoming release. We recommend migrating your network configurations to Netplan.

When installing 7.2.0, existing network configuration are migrated to YAML format and verified to see if they work as expected. If the migration fails, users should set their network configuration manually by configuring a YAML file with the netplan-apply command. Users can also use this command to update existing network configuration after upgrading Logpoint.

Network Configuration Using Netplan¶

To configure networks in Logpoint, you must first create a YAML file that details their setup with the correct indentation. The YAML file must contain a description of the network interfaces, IP addresses, and the paths to the network configuration backend that should be used for each device. After you are done configuring the YAML file, pass it with the netplan-apply command in a terminal to set your network configuration.

Example:

netplan-apply network_config.yaml

Sample YAML file:

network:
  version: 2
  renderer: networkd
  ethernets:
    enp3s0:
      addresses:
        - 10.10.10.2/24
      nameservers:
        search: [mydomain, otherdomain]
        addresses: [10.10.10.1, 1.1.1.1]
      routes:
        - to: default
          via: 10.10.10.1

For more examples of the YAML descriptions, go to Netplan Configuration Examples. Plan properly before you write YAML descriptions, an incorrect YAML file can cause network disruptions or complete network outages. Contact support in case of an outage or disruption.

Helpful?